home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mgr / readme.st < prev   
Text File  |  1990-09-29  |  5KB  |  89 lines
  1. #                        Copyright (c) 1987 Bellcore
  2. #                            All Rights Reserved
  3. #       Permission is granted to copy or use this program, EXCEPT that it
  4. #       may not be sold for profit, the copyright notice must be reproduced
  5. #       on copies, and credit should be given to Bellcore where it is due.
  6. #       BELLCORE MAKES NO WARRANTY AND ACCEPTS NO LIABILITY FOR THIS PROGRAM.
  7.  
  8. ----------------------------------------------------------------------------
  9.  
  10. Here is the atari version of MGR, a network transparent window system
  11. originally written for Unix. This zoo file contains only the binaries,
  12. some docs, and context diffs to the Sparc version of MGR (the file
  13. sparcmgr.tar.Z on flash.bellcore.com). I've also included a limited number
  14. of fonts and icons; more are included with the sparc distribution (q.v.).
  15.  
  16. MGR requires 1 megabyte of memory (more is better!) and the MiNT multitasking
  17. system version 0.6 or better. MiNT was posted to comp.binaries.atari.st,
  18. so check your local archive site if you need a copy. It runs in high or
  19. medium resolution, and should work OK on a moniterm or similar large screen
  20. monitor (all the screen graphics use the line A vector).
  21.  
  22. Some points specific to the Atari version:
  23.  
  24. (1) The ST's mouse has only 2 buttons; to simulate a "middle" mouse button,
  25. press a shift key and either of the mouse buttons (I did it this way to make
  26. things easier for left handers). Bad news: this can be somewhat clumsy,
  27. since a lot of programs use the middle button and not many use the left.
  28. Good news: MGR lets you re-map the mouse buttons any way you like. I like
  29. having the system ("left") button on the right button, the "middle" button
  30. on the left, and the "right" button (which isn't used much) on the shift+button
  31. combination; the sample mgr.rc file shows how you can do this.
  32.  
  33. (2) "Buckey" keys are emulated with the Alternate key, e.g. "Buckey-m" (for
  34. "move text") is ALT-m on the Atari. MGR passes any unrecognized buckey keys
  35. through to applications as (0x80|key), so this provides an easy way for
  36. your programs to read alternate keys.
  37.  
  38. (3) For programs that understand TERMCAP, set the TERM environment variable to
  39. "mgr"; a sample termcap entry for an 80x24 window is provided in misc/termcap,
  40. or you can set TERMCAP according to the output of set_term.prg.
  41.  
  42. (4) Programs with TOS vt52 escape sequences hard-wired in can be run in
  43. a VT52 emulation window; use the provided "vt52.prg" to do this. The calling
  44. sequence is:
  45.    vt52 [program]: run "program" in an 80x25 vt52 window; default is $SHELL
  46.    vt52 -f aux:  : read input from the rs232 port (you'll have to have set
  47.                    the baud rate, etc. already; also, you may lose characters
  48.                    even at 2400 baud).
  49.  
  50. Unless you've got a big screen, you'll probably want to set the font to
  51. something small first with font.prg (e.g. font 1 or font 2).
  52.  
  53. (5) Most MGR client programs want forward slashes ("/") in pathnames instead
  54. of the more usual (under TOS) backslash ("\").
  55.  
  56. (6) The startup file is called "mgr.rc" instead of ".mgrc".
  57.  
  58. (6) Environment variables (use forward slashes in these, too):
  59. DEFAULT_FONT: path to the default font (e.g. "f:/mgr/font/sail6x8r.fnt")
  60. MGRFONT: path to the "font" directory (default is "/mgr/font")
  61. MGRICON: path to the "icon" directory (default is "/mgr/icon")
  62. HOME: place to look for "mgr.rc" startup file (no default)
  63. SHELL: shell to run in windows (default "init.prg")
  64. The first three of these can also be set on the command line.
  65.  
  66.  
  67. Contents:
  68. readme.st:    this file
  69. readme:        original MGR readme
  70. mgr.rc:        a sample startup file
  71. bin:        some executable programs (mgr.prg is the most important
  72.         one, obviously :-). vt52.prg is a VT52 terminal emulator
  73.         that may be used to run TOS programs that don't understand
  74.         TERMCAP (most of them, unfortunately)
  75. doc:        some doc files; usrman.out is the nroff-compiled user guide for
  76.         MGR; the others are nroff manual pages.
  77. font:        some sample fonts
  78. icon:        some sample icons; view with browse.prg.
  79. lib:        the MGR library, in source and gcc archive format. Note that
  80.         the version of libmgr.a provided does *not* include scribe.o;
  81.         I was unable to compile scribe.c (I ran out of memory on my
  82.         4 megabyte ST; probably cross-compiling on a Sun would be the
  83.         only solution, or using a different compiler)
  84. misc:        some miscellaneous files (not all of the ones mentioned in
  85.         the README are included). Try "cat map" and "cat tree.out".
  86. src/atari:    atari bitblit library
  87. atari:        the diffs to the mgr source code
  88. contrib/atari:    the source code for vt52.prg
  89.